docs: add deprecation banners to Android v6 and the legacy sourcemaps tool - #33
Merged
Conversation
… tool Both sections are superseded, and neither says so on the page itself. Android SDK 6.x (21 pages) The only signal that v6 is the previous major version is its position under "Previous versions" in the sidebar — invisible to anyone arriving from a search result, an old bookmark, or a shared link. Adds a :::caution banner to every v6 page pointing at the 6.x -> 7.x migration guide and at the current installation page. Modelled on the Xamarin SDK's per-page deprecation banner, which is the pattern the rest of the site already uses for superseded content. tools/sourcemaps.md /cli/sourcemaps/ already describes this page's subject as "the older bugsee-sourcemaps npm tool", superseded by the CLI's debug-ID-based flow — but the page itself carried no such notice, so a reader landing on it directly had no way to know it is not the recommended path. Adds a banner using the CLI page's own wording. Banners are placed after any MDX import statements, matching the placement in sdk/xamarin/installation.mdx. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Change-Id: I3dc9b52b046c8f1b7a5e1c87ea5f252eb288b71e
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Two sections of the site are superseded, and neither says so on the page.
Android SDK 6.x — 21 pages
Today the only signal that v6 is the previous major version is its placement under "Previous versions" in the sidebar. That is invisible to anyone arriving from a search result, an old bookmark, or a shared link — which is most of the traffic these pages get.
Given the migration guide describes 7.x as a near-total rewrite, silently following a v6 page is a costly wrong turn.
tools/sourcemaps.md— 1 page/cli/sourcemaps/already calls this page's subject "the olderbugsee-sourcemapsnpm tool", superseded by the CLI's debug-ID-based flow. The page itself said nothing. The banner reuses the CLI page's own wording rather than inventing new framing.Approach
Modelled on
sdk/xamarin/installation.mdx, the pattern the site already uses for superseded content. Banners sit after any MDXimportstatements, matching that file's placement. All 21 v6 pages carry exactly one banner; front matter untouched.Conflict resolution carried forward
sdk/android/v6/feedback.mdxneeded a merge with the already-merged #27, which fixed thebuilt in single threadedtypo in the same region this banner occupies. Kept both — banner on top, corrected sentence below. Verified after the cherry-pick:built in single threaded→ 0,built-in single-threaded→ 1.Why this PR exists
The four PRs were stacked (#31 → #30 → #29 → #28). Deleting each head branch after merging closed the child PR one second later, because GitHub closes a PR when its base branch is deleted — and #29 merged into its stacked parent rather than into
main. Only #31 actually landed. This PR and #32/#33 are flat and independent, so the failure mode cannot recur.Checks
npx cspell288 files / 0 issues ·npm run buildsucceeds, no broken links🤖 Generated with Claude Code